home *** CD-ROM | disk | FTP | other *** search
/ PD ROM 1 / PD ROM Volume I - Macintosh Software from BMUG (1988).iso / Desk Accessories / Editors / VMode / VMode ∂ next >
Encoding:
Text File  |  1985-11-17  |  10.4 KB  |  219 lines  |  [TEXT/ttxt]
  1.  
  2. Using Vmode
  3.  
  4. Introduction
  5.  
  6. VMode is a desk accessory--to start it, choose it from the 'Apple' menu while
  7. in Microsoft Word (it will not work within other programs).  Vmode creates a
  8. hybrid editing environment where you can use a large subset of the editing
  9. commands of the editor 'vi', as well as the normal Word editing features.  When
  10. you start VMode a new 'Mode' menu appears at the right.  By selecting the
  11. 'VMode' entry in this menu you can exit or reenter vi mode at any time.
  12.  
  13. While in vi mode, all the normal mouse/menu manipulations are available.  There
  14. are only two Keyboard command differences--in insert mode,'CMD W' no longer
  15. closes windows, in non-insert mode 'CMD D' no longer formats characters.  Word
  16. obeys vi rules only when you are working in document windows:  the usual rules
  17. apply at all other times--while working in a "find" window, in a desk
  18. accessory, etc.
  19.  
  20. Vmode reminds you of what mode you are in by 'inverting' the menubar (white
  21. letters on a black background) when you are in non-insert mode.  Most users
  22. familiar with 'vi' and Word, should find the hybrid editing environment easy to
  23. use.  There are however two features of this environment which will probably
  24. require slight habit adjustments.  1) While in non-insert mode, if you choose
  25. to make changes in text by first selecting the text and then typing new text,
  26. you must remember to type 'i' to get into insert mode before typing the new
  27. text.  2) Backspace never has the "move left non-destructively" meaning it has
  28. in non-insert mode in conventional 'vi'--it always has the effect it would have
  29. in the normal Word environment.  To move left non-destructively in non-insert
  30. mode, use the conventional 'vi' alternative 'h'.
  31.  
  32. The Commands
  33.  
  34. VMode supports most of the conventional vi commands but currently lacks line
  35. operations such as 'dd', 'cc', and 'J'.  VMode works by translating vi commands
  36. into Word commands--so it lacks some commands which require capabilities not
  37. possessed by Word (most sorely missed; backwards searching commands, marking
  38. and returning commands).  The '`' key serves as the escape key--use it to get
  39. to non-insert mode from insertmode, to abort the building of numbers, etc.
  40.  
  41. Non-insert mode
  42.  
  43. Movement commands
  44.  
  45. You may use preceeding numbers to multiply the effects of movement commands.
  46. (However, the use of numbered movement commands may be prohibitively slow for
  47. numbers larger than 30 or so.)
  48.  
  49. 'l', SPACE    move right 
  50. 'h'         move left 
  51. 'j'         move down 
  52. 'k'         move up 
  53. 'RETURN'        beginning of line below 
  54. '-'         beginning of line above 
  55. 'w'         word forward 
  56. 'b'         word back 
  57. ')'         sentence forward 
  58. '('         sentence back
  59. 'H'         top left of visible screen
  60. 'L'         bottom right of visible screen 
  61. '0'         start of line 
  62. '$'         end of line 
  63. 'G'         by itself--to end of file, with number to the start of Nth page
  64. CMD plus 'd'    scroll down one page 
  65. CMD plus 'u'     scroll up one page 
  66. CMD plus '-'    scroll up one line 
  67. CMD plus '+'     scroll down one line
  68.  
  69. The following movement commands work by opening up a search window (but out of
  70. the way where you can't see it), and closing it after the search is over.  This
  71. has two important consequences. 1) For these commands to work smoothly, you
  72. must close every search window that you opened with CMD 'f' or equivalent,
  73. after you are through searching.  (If you do not--for example if you make the
  74. text window the front window by clicking on it--your next use of one of these
  75. commands will not result in a search--it will merely result in the search
  76. window being closed for you).  2) Should a search fail, there will be a
  77. multiple beep sound and a 'search failed' type of window will appear.  You
  78. should close the error window and the find window before doing anything else.
  79.  
  80. You can combine operators (see below) with 'f', 't' and ';' but not the other
  81. movement commands in this section. (Note that you should only do so when the
  82. letter being searched for is visible within the window and on the same line as
  83. the current position--if the letter is on another line, or moving to the letter
  84. results in horizontal scrolling, undesirable results will be obtained.)  Except
  85. when used with operators, there are none of the conventional between-line
  86. movement restrictions for 'f' etc.
  87.  
  88. 'fx'    find and move to the letter 'x'.  
  89. 'tx'    find and move to the character before the letter 'x'.  
  90. ';'     repeats most recent 't' or 'f' search 
  91. 'e'     move to the end of the word 
  92. '}'     move to the start of the next paragraph 
  93. '/'     open search window--equivalent to Command + 'f' (does not take numbers)
  94. 'n'     search for last pattern searched for in most recent Command + 'f' (or
  95.     equivalent) search
  96.  
  97. Insert mode
  98.  
  99. While in insert mode the following have special meanings:  
  100.  
  101. Command + 'w'   
  102.  
  103.     deletes backward one word (differs from the normal Word feature, Option
  104.     + Backspace, in that it avoids deleting forwards when there is no space
  105.     to the right of the current insertion point)
  106.  
  107. Command + Backspace       
  108.  
  109.     expand glossary abbreviation (is equivalent to Command + Backspace
  110.     followed by Command + Shift + Space, so that text typed immediately
  111.     after a glossary expansion is plain text)
  112.  
  113. Command + '`' 
  114.  
  115.     inserts '`' 
  116.  
  117. To start insertion use the following commands:  
  118.  
  119. 'i'     insert starting at current position 
  120. 'a'     insert starting one char right of current position 
  121. 'I'     insert starting at beginning of line
  122. 'A'     insert starting at end of line 
  123.  
  124. Operators 
  125.  
  126. These commands combine with motion commands to effect all characters
  127. from the current character to the movement destination.
  128.  
  129. 'y'     ("yank") copies characters to clipboard 
  130. 'd'     ("delete") cuts characters to clipboard
  131. 'c'     ("change") cuts characters to clipboard and leaves in insert mode 
  132. 'Y'     selects characters.  
  133.  
  134. Simple changes 
  135.  
  136. 'rX'    replace current character with 'X' 
  137. 'x'     delete N characters forward from current character 
  138. 's'     delete N characters and leave in insert mode
  139. 'X'     delete N characters backward from character before current character 
  140. 'D'     delete from current position to end of line 
  141. 'C'     delete from current position to end of line and leave in insert mode
  142.  
  143. Miscellaneous 
  144.  
  145. 'p'     paste contents of clipboard to right of current position 
  146. 'P'     paste contents of clipboard to left of current position 
  147. 'u'     undo 
  148. '.'     redo 
  149.  
  150. (The following discussion assumes that you have edited Word with the Resource
  151. Editor so that Command + 'l' is equivalent to Show Glossary see above.)
  152. Normally operators ('d', 'y', etc.) and the put commmands ('p', and 'P') cut,
  153. copy and paste text to and from the clipboard.  It is possible to cut, copy and
  154. paste to and from 'named buffers' by preceding the command with '"' (double
  155. quote) and a single letter.  Thus '"ad2w' deletes two words and puts them in
  156. buffer a, while '"bp' pastes from buffer b.  (The named buffers are actually
  157. glossary entries--Oa for buffer a, etc.)
  158.  
  159. Installing Vmode
  160.  
  161. To install Vmode, you must use Resource Editor of creation date Jan.  25, 1985
  162. or later.  You install vmode by copying the 'DRVR' type resource in the file
  163. named 'vmode' and pasting it into your System file.  (You may wonder why it is
  164. not more appropriate to add the driver to Word itself--while this is possible,
  165. the addition alerts part of the copy-protection scheme and you will have to
  166. insert the master disk every time you use the program).  You will probably also
  167. want to modify Menu ID 258 of Word so that Command-key + 'l' (the letter 'el')
  168. is equivalent to 'Show Glossary'--this will allow you to use the named buffers
  169. --see below.
  170.  
  171. Past and Future
  172.  
  173. This program started as something I called MacMacros--a desk accessory for use
  174. in any program which makes it possible for any key to be expanded into any
  175. arbitrary combination of key strokes.  I gave it a mode that made Word obey vi
  176. rules.  For the moment I have decided not to distribute MacMacros principally
  177. for two reasons.  1) The appearance on the market (before completing MacMacros)
  178. of Assimilation Inc.'s MacTracks.  For most people, and for most purposes, this
  179. program will provide an adequate means of creating macros within programs.  (It
  180. is compatible with VMode and can be used to create vi macros).  2) The fact
  181. that I am a biologist and program as a sideline--I don't have time at the
  182. moment to make MacMacros as powerful and user-friendly as I'd like.
  183.  
  184. However, there are certain features necessary for an optimally useful macro
  185. program which MacTracks lacks.  These include a) the ability to edit existing
  186. macros (so you don't have to type a long one in all over again to correct one
  187. mistake) b) the ability to create macros that work for a while in one
  188. application and then work for a while in another (either with one program
  189. ending, and the other beginning, or in the switcher environment) c) the ability
  190. to make a macro repeat itself a set number of times or repeat itself
  191. indefinitely until some condition is met d) the ability to generate a number of
  192. null events to pad some events--for some programs (such as Word) which display
  193. certain bugs when commands follow upon each other too quickly e) the ability to
  194. manipulate windows independently of their current dimensions or positions (eg.
  195. making it possible to include a command equivalent to "click on the title bar
  196. of the window which is third from the front").  As MacMacros has most of these
  197. features, I may yet
  198.  
  199. For the near future my plans are to release desk accessories equivalent to
  200. VMode which will make Word obey the syntax of other popular editors (eg.
  201. WordStar).
  202.  
  203. In closing, I leave you with two tips for using the current version of
  204. MacTracks.  1) When you are using the Switcher, you may start up the desk
  205. accessory in one application (to make a new macro or whatever) but if you start
  206. it in another, the system crashes.  It is possible to use macros in more than
  207. one application but they have to have been created ahead of time in all but one
  208. application.  2) Within Word, commands tend to get lost after commands that
  209. opened, closed or manipulated a window (particularly the find window).  Pad
  210. these commands by grabbing a window, moving it slightly and then moving it
  211. back.  Also, it seems to be safer to select a command from the menu rather than
  212. use the keyboard equivalent.
  213.  
  214. Apple is a trademark of Apple Computer, Inc.  Macintosh is a registered
  215. trademark licensed to Apple Computer, Inc.  Switcher is a registered trademark
  216. of Apple Computer, Inc.  Microsoft is a registered trademark of Microsoft Corp.
  217. MacTracks is a trademark of Assimilation, Inc.  WordStar is a registered
  218. trademark of MicroPro International Corp.
  219.